Picklist Fields

Picklists allow users to select a value from a predefined list. Lucity picklists often consist of two fields: One contains a Code and the other a Description or Type. Sometimes the available values are carried over from another module (e.g., assets lists, resource options, locations, etc.).

Example:  

Codes

The code portion of a picklist field can either be a number or text field.

  • Numeric - These pick-lists allow only a number in the Code field.
  • Alphanumeric - These pick-lists allow a mix of numbers and letters in the Code field.

Selectable Values

The values users can select in picklists come from one of two sources:

  • User-defined picklist - These picklists often track an attribute. The values available in these picklists are established by the agency using Lucity.
  • Module-defined picklist - These picklists are used to select a record from another module in the Lucity system. The values available in these picklists are automatically populated using data from the related module.

Picklist Appearance

  • Single drop down - Both code and description are displayed but the values are selected from a drop down list in the description field that displays the Code and Description together:

  • Dual drop down - Separate drop down lists for the code and description. When the user makes a selection in one field, the system automatically completes the other field:

  • Picklist - An empty text box for the code and a 3 horizontal lines select picklist button button next to the description. Enter the code and exit the field to automatically populate the description, or, click the 3 horizontal lines select picklist button button to view a pop-up window of options:

Picklist Field Component Information

Use the Component Information pop-up Form grid with pencil edit component info icon to edit the field's properties. The pop-up will display the properties for the code part of the picklist, the type part of the picklist, and properties that affect both.

Field Description

Property Name

Identifies the property associated with the field(s). This relationship helps third-party developers correlate form data with the properties available in the back-end.

Label

Sets the text that will be displayed on the form.

Hidden

Indicates that the field should be hidden. This is useful for simplying forms while still setting a default values for the field.

Required

Forces the user to enter information in this field in order to save the record.

Note:  The Required property for the Category field is "True" by default. For all other fields, the Required property is "False" by default.

Readonly

Designates the field as read-only, which prevents the user from entering data on this form.

Carry Over

Enables/disables the green Carry Over button for the selected field. To prevent users from seeing Carry Over buttons throughout the entire form, the grid the form is attached to must be edited to hide the Display Carry Over Buttons button. More details

Note:  Fields marked as read-only never display the Carry Over button in Lucity Web, even if this option is enabled.

Component Type

Indicates the picklist style displayed on the form.

Tree Display

Only appears when the Component Type is Site Picklist, Building Picklist, or Park Picklist. Makes the Asset Rec # field's pop-up an asset driven list that controls whether the asset tree identifies the assets using the Code, Type, or Both.

Tree Filter

Only appears when the Component Type is Site Picklist, Building Picklist, or Park Picklist. Enables an administrator to type in a sql statement to narrow down the list of records at the top teir of the asset tree.

Limit List

Opens the limit list dialog which enables the user to control which picklist values are available for the selected field.